Oracle Data Service Integrator Documentation > Data Services Developer's Guide
Exporting Dataspace Project Artifacts Using Oracle Data Service Integrator Export Wizards
This section describes the various types of export operations available for Oracle Data Service Integrator dataspace projects.
Topics
Exporting Dataspace Artifacts
The Oracle Data Service Integrator export wizards can be accessed using the File > Export menu, then expand on the Oracle Data Service Integrator export wizard category.
File > Export... > Oracle Data Service Integrator
 | Artifacts can only be exported from deployable dataspace projects; if your project is not deployable, the export operation will not succeed. |
Exporting a Dataspace Project
In the Oracle Data Service Integrator category there are three wizards. Each generates a specific type of JAR file.
Types of Oracle Data Service Integrator JAR File Export Operations
| Export Type |
Effect |
|---|---|
| Data service definitions and artifacts | All Oracle Data Service Integrator deployable artifacts are bundled into a JAR file. |
| Mediator client |
A Java interface for accessing data services is created. |
| Web services mediator client | A web services interface for accessing data services is created. |
 | Any dataspace projects pre-selected in the Project Explorer will automatically be selected in the export wizard. |
Generating a Data Service Definitions and Artifacts JAR
An exported JAR file containing a single project's server-deployable definitions and artifacts. Such a file can be imported into another Oracle Data Service Integrator-enabled version of Eclipse. In addition, the definitions and artifacts JAR can be useful:
- As a means of transporting a dataspace from one application to another.
- In conjunction with certain refactoring operations.
- For deployment on multiple servers (clusters) at a later time.
- For debugging purposes.
Export Data Service Definitions and Artifacts
In the wizard, the contents you identify using their adjacent checkbox will be exported. For example if you check the box next to the project name, all of that projects server-deployable components will be selected.
You can fine-tune your selection by clicking on a folder. The folder's contents will appear in the right-hand column where you can use a checkbox to control which artifact will be exported.
Actions Associated with Generating a Data Service Definitions and Artifacts JAR
| Item | Recommended Setting or Action | Details - Comments |
|---|---|---|
| Export Data Service Definitions and Artifacts Page | ||
| Check folders or their contents that you want to export |
|
|
| Deselect All | |
Convenience if more than one project is selected. |
| To Directory: |
/user_projects/helloworld |
JAR file can be exported anywhere on the system. |
| Filename: | -artifacts.jar |
Example:mySpace-dsp-client.jar |
| Use default filename option | Selected |
When selected editing of the generated filename is not allowed. |
| Overwrite existing file without warning option | Unselected |
If unselected you will be asked if you want to overwrite any existing file of the same name. |
| Success message |
Finish |
Identifies project and target name. |
Generating a Mediator Client JAR File
This wizard presents a list of open Oracle Data Service Integrator projects to select from, and it generates an Oracle Data Service Integrator mediator client JAR file from the currently selected project. Projects are exported one at a time.
Java programs access data services through the Oracle Data Service Integrator Mediator API. This API is generated from the Oracle Data Service Integrator Eclipse platform and is based on a project that can be successfully built and deployed.
 | Accessing Data Services from Java Clients |
Export Mediator Client JAR Wizard
Steps Associated with Generating a Mediator Client API JAR File
| Item | Recommended Setting or Action | Details - Comments |
|---|---|---|
| Select the Mediator Client JAR File export wizard | ||
| Type: |
Mediator Client JAR File | |
| Select a Dataspace Project Page |
Next | |
| Pick a dataspace project |
mySpace |
Only one project at a time can be exported. |
| Deselect All | |
Convenience if more than one project is selected. |
| To Directory: |
/user_projects/helloworld |
JAR file can be exported anywhere on the system. |
| Filename: | -dsp-client.jar |
Example: mySpace-dsp-client.jar |
| Use default filename option | Selected |
When selected editing of the generated filename is not allowed. |
| Overwrite existing file without warning option | Unselected |
If unselected you will be asked if you want to overwrite any existing file of the same name. |
| Success message |
Finish |
Identifies project and target name. |
Generating a JAR File Containing Data Service-to-Web Service Maps
After you have created a web service map of one or more data services you can create an exported JAR file containing these maps.
Then the created JAR file can be used as your applications web service interface to available data services.
| Only publicly available operations can be turned into web service operations. You can adjust access level to a data service function through the Properties window. |
Exporting a Web Services Mediator Client JAR File
Actions Associated with Generating a Web Services Mediator Client JAR File
| Item | Recommended Setting or Action | Details - Comments |
|---|---|---|
| Export Web Services Mediator Client JAR File | ||
| Check folders or their contents that contain web service maps |
Select folder |
Click on the exportable dataspace folder to located selected WS file. |
| Deselect All | |
Convenience if more than one project is selected. |
| To Directory: |
/user_projects/helloworld |
JAR file can be exported anywhere on the system. |
| Filename: | -ws-client.jar |
Example:mySpace-ws-client.jar |
| Use default filename option | Selected |
When selected editing of the generated filename is not allowed. |
| Overwrite existing file without warning option | Unselected |
If unselected you will be asked if you want to overwrite any existing file of the same name. |
| Success message |
Finish |
Identifies project and target name. |
